home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 176-200 / disk_189 / mackie / readme < prev    next >
Text File  |  1992-05-06  |  10KB  |  235 lines
  1. Mackie 1.2 release
  2.  
  3. - Selection of five screen blanking modes
  4. - New `patterns' keyword to select blanking mode
  5. - Changes screen blanking patterns every five minutes
  6.  
  7. Mackie 1.13 release
  8.  
  9. - Faster, machine language splines
  10. - Changes from splines->boxes->lines
  11.  
  12. Mackie 1.12 release
  13.  
  14. - Adds splines (compile with -DSPLINES)
  15. - Time of `0' disables screen blanking
  16.  
  17. Mackie 1.11 release
  18.  
  19. This release fixes a few bugs in the 1.1 alpha release.
  20.  
  21. - Function keys work now.
  22. - Any spawned commands have a priority of 0, not 20.
  23. - The -f option works.
  24. - The .mackierc file is closed after it is read.
  25. - Some minor space improvements.
  26.  
  27. Mackie 1.1 (beta release for 1.2) is now available.  This revision has
  28. significantly greater functionality than the original Mackie, and I am
  29. releasing it in hopes of getting comments and improvements.
  30.  
  31. To get the program, anonymous ftp it from labrea.stanford.edu (in ~pub)
  32. or send me mail; I'll send it to you by Email or physical mail (at least
  33. to the first 20 people who ask).  You'll get both source and executable;
  34. comments on the source is greatly appreciated.
  35.  
  36. Those of you who have used Lisp machines or TI Explorers will recognize
  37. how this works.  I've added a `System' key to the Amiga, by taking over
  38. the help key.  If I want to edit a file, I simply hit `Help' then `E'.
  39. If an editor already has a window open, it will be popped to front;
  40. otherwise, an editor will be spawned.  Similarly, `Help' `V' will give
  41. me a VT100 window, whether one exists or not.  If I want a new editor,
  42. regardless of ones that current exist, `Help' CTRL-E will give me one.
  43.  
  44. Let's plunge right in, by examining my current startup file.
  45.  
  46. *
  47. *   Typical .mackierc file; set the default pop
  48. *   command:
  49. *
  50. command "newwsh con:10/10/640/200/MackieCLI"
  51. ;
  52. ;   and the timeout:
  53. ;
  54. timeout 200
  55. ;
  56. ;
  57. ;
  58. patterns 023
  59. #
  60. #   Now define some system keys
  61. #
  62. space cli "" "newwsh"
  63. t cli "tex*" "newwsh con:20/20/640/100/texwsh cmd tex"
  64. p intuition "preview*" "preview"
  65. e intuition "mg*" "mg"
  66. v intuition "vt100*" "run vt100"
  67. d intuition "dfc*" "dfc"
  68.  
  69. w intuition ""
  70.  
  71. So, all the POPCLI stuff is still in there.  I'll address the system keys
  72. one by one.
  73.  
  74. The patterns line selects what patterns to display.  `0' is the original
  75. mackie lines patterns; `1' is a single Bezier spline; `2' is the standard
  76. qix; `3' is a four-line qix; `4' is sets of three splines in a closed curve,
  77. and `R' is pick one randomly.  It rotates patterns on a 5-minute basis.
  78.  
  79. The line that starts with `space' means that whenever `Help' `Space' is
  80. pressed, the next CLI window that matches the empty string is brought
  81. to the front.  The only CLI windows with a null command are the ones
  82. not executing a command, so this gives me a CLI ready for a command.
  83.  
  84. The line that starts with `t' means that `Help' `t' will look for a CLI
  85. executing a command starting with the three characters `tex', and pop it
  86. to front.  If one doesn't exist, one is started.  Note that all string
  87. comparisons here are case insensitive, and that `*' means match all the
  88. rest of the characters.
  89.  
  90. The syntax for the startup file is each line is an empty line, a comment,
  91. a parameter line, or a system key definition.  Comment lines start with
  92. semicolons, hashes, or splats.  Parameter lines start with `command',
  93. `timeout', `blank', or `lines'.  Timeout must be folled by a number,
  94. and command must be followed by a string.  Separators are tabs, spaces,
  95. equal signs, commas, or hyphens.
  96.  
  97. System key definitions start with the key being defined.  Allowable
  98. keys are A-Z or 0-9 (as themselves), F1 through F10 for the function
  99. keys, or Space for the space key.  The keyword `Shift' can precede the
  100. key.  After the key, an optional `CLI' or `Intuition' keyword can be
  101. placed.  These will be described later.
  102.  
  103. After the optional keyword, one or two strings should be found.  The
  104. first string is the command to match; the second string (if given) is
  105. the command to execute if no matches are found.  This command should
  106. return relatively quickly; if the program doesn't detach, then you want
  107. to precede the command with a `run' or `newcli' so it does.
  108.  
  109. Strings are bracketed by double quotes; a backslash-double quote means
  110. a literal double quote.
  111.  
  112. Any key that doesn't have a definition in the startup file gets a default
  113. definition; for the letter keys A-Z, the default definition is
  114.  
  115. X "X*"
  116.  
  117. for example, which means match any window starting with `X', be it a CLI
  118. or an Intuition window.  The number keys match only the CLI with that
  119. particular number.  The space key by default matches any window (so it just
  120. cycles all of the windows), and the function keys match nothing.
  121.  
  122. Windows are not matched by their title; the title is often blank or used
  123. for error messages and the like.  Instead, windows are matched by the
  124. name of the task associated with the window for Intuition windows, or the
  125. command being executed by the CLI in the case of CLI windows.  Thus, the
  126. program doesn't work very well with programs that use strange task names.
  127. For instance, Manx db uses the name `Aztec_db', so you'd have to match
  128. that, rather than the intuitive `db'.
  129.  
  130. There are three classes of programs.  There are those programs that run
  131. from the workbench or detach themselves from a CLI; these programs have
  132. only an Intuition window associated with them.  An example of this class
  133. is Manx `db'.  There are those programs that interact only through the CLI
  134. windows; an example of these is `tex'.  And finally, there are programs
  135. that run from a CLI but do their interaction through an Intuition window;
  136. an example of this is `vt100'.
  137.  
  138. Only the third class offers any ambiguity; the question is whether to
  139. active the CLI window or the Intuition window.  But the type of window is
  140. usually specified for the other kinds anyway, to help limit the search.
  141.  
  142. If you give a search string such as `!xyzzy!' that isn't likely to be
  143. matched, then the command string is always executed, so you can bind
  144. arbitrary commands to a system key.
  145.  
  146. Oh, yes; one important thing.  Hitting `help' twice passes a help key
  147. on through the input stream, so you haven't lost your help key.
  148.  
  149. The code will only compile with Manx.
  150.  
  151. Usage is simply:
  152.  
  153.    run mackie [-q] [-l] [-b] [-f filename] [command] [time]
  154.  
  155. Note that it doesn't automatically detach itself, so the `RUN' is
  156. necessary.  The first time you run it, it loads itself into RAM.
  157. Subsequent invocations need not be `run', as they notice the running
  158. portion of the program and simply send new parameters to it.
  159.  
  160. The options mean:
  161.  
  162.    -q             Quit.  Remove the resident portion from memory.
  163.    -l             Lines.  Draw lines instead of a blank screen.  (Default)
  164.    -b             Blank.  Draw a blank screen instead of fancy lines.
  165.    -f filename    Startup file (default is s:.mackierc).
  166.  
  167. A time is an argument that starts with a digit; this time is in seconds.
  168. After that much inactivity, the screen blanking starts.
  169.  
  170. A command is an argument that starts with neither digits nor a hyphen.
  171. This is the command executed whenever left-amiga ESC is pressed.
  172.  
  173. Thus, the command
  174.  
  175.    run mackie "newcli con:10/10/640/200/MackieCLI"
  176.  
  177. starts mackie up, and sets the command to be executed to a NewCLI with a
  178. specified size.  Later, if you want to see the screen blanking feature
  179. quickly, just type
  180.  
  181.    mackie 1
  182.  
  183. and in a second, the screen will go blank.  If the lines are driving you
  184. wild, you might type
  185.  
  186.    mackie -b
  187.  
  188. to turn them off.  Finally, you need every byte of memory, so you want to
  189. remove mackie.  Simply type
  190.  
  191.    mackie -q
  192.  
  193. That's all there is to it.
  194.  
  195. Enjoy this program!  Send bug reports to Tomas Rokicki, Box 2081,
  196. Stanford, CA  94309.
  197.  
  198. Based on:
  199.  
  200. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  201. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  202. /* |. o.| || This program may not be distributed without the permission of   */
  203. /* | .  | || the authors.                                                    */
  204. /* | o  | ||    Dave Baker     Ed Burnette  Jay Denebeim John Mainwaring     */
  205. /* |  . |//     Gordon Keener  Jack Rouse   John Toebes  Doug Walker         */
  206. /* ======                    BBS:(919)-471-6436                              */ 
  207. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  208.  
  209. POPCLI III by John Toebes © 1987 The Software Distillery.  All Rights Reserved
  210.  235 Trillingham Ln, Cary, NC 27511
  211.  
  212. Contributions to continue development of this and other fine products for the
  213. Amiga should be sent to the Software Distillery at the above address.
  214.  
  215. Other Products produced by the Software Distillery are:
  216.    BLINK    - the Turbo-charged Alink replacement
  217.    HACK     - The Amiga port of the famous UNIX game
  218.    LARN     - Another famous UNIX game
  219.    MEMWATCH - Protects your machine from random trashes
  220.    MAKE     - A software development tool one shouldn't be without
  221.    KERMIT   - The World renown file transfer protocol brought to the Amiga
  222.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  223.    TSIZE    - A short utility for determining directory sizes.
  224. All of these are available on our BBS.
  225.  
  226. Permission is hereby granted to distribute this program provided both this
  227. documentation accompanies the executable and that no charge is made for its
  228. distribution.
  229.  
  230. POPCLI (pronounced POP-SEE-EL-EYE) is designed to solve two problems at once.
  231. First it provides a simple way of starting another CLI at any time without
  232. having to load workbench or exit whatever program you may be using.  Second
  233. it has a builtin screen saver mode that automatically turns off the Amiga
  234. display when there has been no input for a given period of time.
  235.